home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / msdos / echoblk.zip / ECHOBLOK.DOC next >
Text File  |  1993-10-14  |  5KB  |  84 lines
  1.  
  2. ________ECHOBLOK                                                          Ver. 2.30
  3.  
  4. Purpose: EchoBlok is made to be used with DOS 6's CONFIG.SYS menu system.
  5.          It prints on screen just the parts of a CONFIG.SYS file that would
  6.          be operative under a given menu choice.  You might use it in a DOS
  7.          boot-up screen, and it may be useful in debugging a complex
  8.          CONFIG.SYS.
  9.  
  10. Format:     ECHOBLOK [filespec] [header]
  11.  
  12.                                         ________         Both parameters are optional.  filespec defaults to CONFIG.SYS (in
  13.                                                          ______         the current directory).  There's no default for header.
  14.  
  15.          You may but needn't put [brackets] around the header spec.
  16.  
  17.          If you give only one parameter, EchoBlok tries to open a file by
  18.          that name.  If it can, it prints the whole file.  If there's no
  19.          such file, it takes the parameter for a block specification and
  20.          looks in CONFIG.SYS (in the current directory);
  21.  
  22.          DOS puts the name of the header chosen at the CONFIG.SYS menu into
  23.          an environment variable, CONFIG.  Therefore, you can cover most of
  24.          the ground in an AUTOEXEC.BAT line that runs:
  25.  
  26.             ECHOBLOK C:\CONFIG.SYS %CONFIG%
  27.  
  28. Remarks: My AUTOEXEC.BAT leaves me in DOS, with a screen showing informa-
  29.          tion about what's running, what TSR's are loaded, etc.  In the
  30.          past, I kept a small stable of CONFIG.SYS files to swap in as
  31.          wanted.  So, usually, it was convenient to simply TYPE the whole
  32.          CONFIG.SYS file onto the boot-up screen to show what's going on.
  33.  
  34.          DOS 6 gives us a menu system in CONFIG.SYS now, so all my little
  35.          CONFIG.xxx files are collected into one, and I get to choose from
  36.          a menu.  It's convenient, but now CONFIG.SYS is too big to fit on
  37.          a screen, and most of it's irrelevant, because only the block I
  38.          called for is operative.  Hence, EchoBlok.  It reads CONFIG.SYS
  39.          and puts on the screen the text of the header block called for.
  40.  
  41.          There are two complications.  First, if there are several blocks
  42.          in CONFIG.SYS with the same name (it would be a bungle), only the
  43.          first one will be used.  The exception is [COMMON].  DOS will exe-
  44.          cute every block with this label, however many.  Second, an IN-
  45.          CLUDE statement in one block will activate another.  INCLUDEs are
  46.          recursive, so blocks INCLUDEd in an INCLUDEd block will also be
  47.          executed.  EchoBlok reads the file just the way DOS 6 does and
  48.          displays exactly the lines that DOS 6 would execute, in the order
  49.          in which DOS 6 would execute them.
  50.  
  51.          If you give a single parameter, EchoBlok tries it as a filespec.
  52.          If it can't find such a file, it takes it for the header name, and
  53.          EchoBlok will look at CONFIG.SYS.  You can force it to be a header
  54.          block by [bracketing] it.  If you give two parameters, the first
  55.          becomes the filename and the second becomes the header name.  If
  56.          there's no header request or if the header it's looking for isn't
  57.          in the file, EchoBlok will say so and print the whole file.  If
  58.          you give no parameters (or just ?), you get a help screen.
  59.  
  60.          Since EchoBlok writes to standard output, you can redirect its
  61.          output to a printer or a file.
  62. ________ECHOBLOK                                                             Page 2
  63.  
  64. Version History:
  65.  
  66.             1.00 Printed executable lines in order of their appearance.
  67.                    (8/93)
  68.             2.00 Printed in order of execution. (8/93)
  69.             2.10 Parameter /ALL prints the whole file. (not issued) (9/93)
  70.             2.20 If header not found or not given, prints the whole file.
  71.                    (10/93)
  72.             2.30 Bugs fixed: [COMMON] blocks correctly reproduced, Blocks
  73.                    end on next [header] (not on blank line), reads read-
  74.                    only files. (10/93)
  75.  
  76. Legal notice:
  77.  
  78.          (C) Copyright R. N. Wisan, 1993.  All rights waived except that no
  79.          one has permission to deny anyone permission to use or distribute
  80.          this program and its DOC.
  81.  
  82.                                                  R. N. Wisan, October, 1993
  83.                                           37 Clinton St., Oneonta, NY 13820
  84.                                               internet: WISANR@hartwick.edu